Inside Macintosh: Mac OS 8 Toolbox Reference /

Chapter 2 - Control Manager Reference / Control Manager Functions

Defining Your Own User Pane Functions /

MyUserPaneIdleProc

NEW WITH THE APPEARANCE MANAGER

Performs idle processing.

The Control Manager declares the type for an application-defined user pane idle function as follows:

typedef pascal void (*ControlUserPaneIdleProc)(ControlHandle control);

The Control Manager defines the data type ControlUserPaneIdleUPP to identify the universal procedure pointer for this application-defined function:

typedef UniversalProcPtr ControlUserPaneIdleUPP;

You typically use the NewControlUserPaneIdleProc macro like this:

ControlUserPaneIdleUPP myControlUserPaneIdleUPP;
myControlUserPaneIdleUPP = NewControlUserPaneIdleProc(MyUserPaneIdle);

You typically use the CallControlUserPaneIdleProc macro like this:

CallControlUserPaneIdleProc(myControlUserPaneIdleUPP, control);

Here's how to declare the function MyUserPaneIdleProc:

pascal void MyUserPaneIdleProc (ControlHandle control);

control

A handle to the control for which you wish to perform idle processing.

DISCUSSION

This function will only get called if you've set the kControlWantsIdle feature bit on creation of the user pane control. Once you have created the function MyUserPaneIdleProc, pass kControlUserPaneIdleProcTag in the tagName parameter of SetControlData.